/*******************************************************************************
* Copyright (c) 2003, 2010 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
package org.eclipse.ui.actions;
import org.eclipse.jface.action.IContributionItem;
import org.eclipse.jface.preference.IPreferenceStore;
import org.eclipse.jface.util.IPropertyChangeListener;
import org.eclipse.jface.util.PropertyChangeEvent;
import org.eclipse.ui.IEditorPart;
import org.eclipse.ui.IPartListener;
import org.eclipse.ui.IWorkbenchCommandConstants;
import org.eclipse.ui.IWorkbenchPart;
import org.eclipse.ui.IWorkbenchWindow;
import org.eclipse.ui.commands.ICommandService;
import org.eclipse.ui.internal.ChangeToPerspectiveMenu;
import org.eclipse.ui.internal.IPreferenceConstants;
import org.eclipse.ui.internal.IWorkbenchGraphicConstants;
import org.eclipse.ui.internal.ReopenEditorMenu;
import org.eclipse.ui.internal.ShowInMenu;
import org.eclipse.ui.internal.ShowViewMenu;
import org.eclipse.ui.internal.SwitchToWindowMenu;
import org.eclipse.ui.internal.WorkbenchImages;
import org.eclipse.ui.internal.WorkbenchPlugin;
import org.eclipse.ui.internal.actions.HelpSearchContributionItem;
import org.eclipse.ui.internal.tweaklets.TabBehaviour;
import org.eclipse.ui.internal.tweaklets.Tweaklets;
import org.eclipse.ui.menus.CommandContributionItem;
import org.eclipse.ui.menus.CommandContributionItemParameter;
/**
* Access to standard contribution items provided by the workbench.
* <p>
* Most of the functionality of this class is provided by
* static methods and fields.
* Example usage:
* <pre>
* MenuManager menu = ...;
* IContributionItem reEdit
* = ContributionItemFactory.REOPEN_EDITORS.create(window);
* menu.add(reEdit);
* </pre>
* </p>
* <p>
* Clients may declare subclasses that provide additional application-specific
* contribution item factories.
* </p>
*
* @since 1.0
*/
public abstract class ContributionItemFactory {
/**
* Id of contribution items created by this factory.
*/
private final String contributionItemId;
/**
* Creates a new workbench contribution item factory with the given id.
*
* @param contributionItemId the id of contribution items created by this factory
*/
protected ContributionItemFactory(String contributionItemId) {
this.contributionItemId = contributionItemId;
}
/**
* Creates a new standard contribution item for the given workbench window.
* <p>
* A typical contribution item automatically registers listeners against the
* workbench window so that it can keep its enablement state up to date.
* Ordinarily, the window's references to these listeners will be dropped
* automatically when the window closes. However, if the client needs to get
* rid of a contribution item while the window is still open, the client must
* call IContributionItem#dispose to give the item an
* opportunity to deregister its listeners and to perform any other cleanup.
* </p>
*
* @param window the workbench window
* @return the workbench contribution item
*/
public abstract IContributionItem create(IWorkbenchWindow window);
/**
* Returns the id of this contribution item factory.
*
* @return the id of contribution items created by this factory
*/
public String getId() {
return contributionItemId;
}
/**
* Workbench action (id "pinEditor"): Toggle whether the editor is pinned.
* This action maintains its enablement state.
* @since 1.1
*/
public static final ContributionItemFactory PIN_EDITOR = new ContributionItemFactory(
"pinEditor") { //$NON-NLS-1$
private static final String COMMAND_ID = IWorkbenchCommandConstants.WINDOW_PIN_EDITOR;
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(final IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
CommandContributionItemParameter parameter = new CommandContributionItemParameter(
window,
COMMAND_ID,
COMMAND_ID,
null,
WorkbenchImages
.getImageDescriptor(IWorkbenchGraphicConstants.IMG_ETOOL_PIN_EDITOR),
WorkbenchImages
.getImageDescriptor(IWorkbenchGraphicConstants.IMG_ETOOL_PIN_EDITOR_DISABLED),
null, null, null, null,
CommandContributionItem.STYLE_CHECK, null, false);
final IPropertyChangeListener[] perfs = new IPropertyChangeListener[1];
final IPartListener partListener = new IPartListener() {
public void partOpened(IWorkbenchPart part) {
}
public void partDeactivated(IWorkbenchPart part) {
}
public void partClosed(IWorkbenchPart part) {
}
public void partBroughtToTop(IWorkbenchPart part) {
if (!(part instanceof IEditorPart)) {
return;
}
ICommandService commandService = (ICommandService) window
.getService(ICommandService.class);
commandService.refreshElements(COMMAND_ID, null);
}
public void partActivated(IWorkbenchPart part) {
}
};
window.getPartService().addPartListener(partListener);
final CommandContributionItem action = new CommandContributionItem(
parameter) {
public void dispose() {
WorkbenchPlugin.getDefault().getPreferenceStore()
.removePropertyChangeListener(perfs[0]);
window.getPartService().removePartListener(partListener);
super.dispose();
}
};
perfs[0] = new IPropertyChangeListener() {
public void propertyChange(PropertyChangeEvent event) {
if (event.getProperty().equals(
IPreferenceConstants.REUSE_EDITORS_BOOLEAN)) {
if (action.getParent() != null) {
IPreferenceStore store = WorkbenchPlugin
.getDefault().getPreferenceStore();
boolean reuseEditors = store
.getBoolean(IPreferenceConstants.REUSE_EDITORS_BOOLEAN)
|| ((TabBehaviour) Tweaklets
.get(TabBehaviour.KEY))
.alwaysShowPinAction();
action.setVisible(reuseEditors);
action.getParent().markDirty();
if (window.getShell() != null
&& !window.getShell().isDisposed()) {
// this property change notification could be
// from a non-ui thread
window.getShell().getDisplay().syncExec(
new Runnable() {
public void run() {
action.getParent()
.update(false);
}
});
}
}
}
}
};
WorkbenchPlugin.getDefault().getPreferenceStore()
.addPropertyChangeListener(perfs[0]);
action.setVisible(WorkbenchPlugin.getDefault().getPreferenceStore()
.getBoolean(IPreferenceConstants.REUSE_EDITORS_BOOLEAN)
|| ((TabBehaviour) Tweaklets.get(TabBehaviour.KEY))
.alwaysShowPinAction());
return action;
}
};
/**
* Workbench contribution item (id "openWindows"): A list of windows
* currently open in the workbench. Selecting one of the items makes the
* corresponding window the active window.
* This action dynamically maintains the list of windows.
* @since 1.1
*/
public static final ContributionItemFactory OPEN_WINDOWS = new ContributionItemFactory(
"openWindows") { //$NON-NLS-1$
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
return new SwitchToWindowMenu(window, getId(), true);
}
};
/**
* Workbench contribution item (id "viewsShortlist"): A list of views
* available to be opened in the window, arranged as a shortlist of
* promising views and an "Other" subitem. Selecting
* one of the items opens the corresponding view in the active window.
* This action dynamically maintains the view shortlist.
*/
public static final ContributionItemFactory VIEWS_SHORTLIST = new ContributionItemFactory(
"viewsShortlist") { //$NON-NLS-1$
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
return new ShowViewMenu(window, getId());
}
};
/**
* Workbench contribution item (id "viewsShowIn"): A list of views
* available to be opened in the window, arranged as a list of
* alternate views to show the same item currently selected. Selecting
* one of the items opens the corresponding view in the active window.
* This action dynamically maintains the view list.
* @since 1.1
*/
public static final ContributionItemFactory VIEWS_SHOW_IN = new ContributionItemFactory(
"viewsShowIn") { //$NON-NLS-1$
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
ShowInMenu showInMenu = new ShowInMenu();
showInMenu.setId(getId());
showInMenu.initialize(window);
return showInMenu;
}
};
/**
* Workbench contribution item (id "reopenEditors"): A list of recent
* editors (with inputs) available to be reopened in the window. Selecting
* one of the items reopens the corresponding editor on its input in the
* active window. This action dynamically maintains the list of editors.
* @since 1.1
*/
public static final ContributionItemFactory REOPEN_EDITORS = new ContributionItemFactory(
"reopenEditors") { //$NON-NLS-1$
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
return new ReopenEditorMenu(window, getId(), true);
}
};
/**
* Workbench contribution item (id "perspectivesShortlist"): A list of
* perspectives available to be opened, arranged as a shortlist of
* promising perspectives and an "Other" subitem. Selecting
* one of the items makes the corresponding perspective active. Should a
* new perspective need to be opened, a workbench user preference controls
* whether the prespective is opened in the active window or a new window.
* This action dynamically maintains the perspectives shortlist.
*/
public static final ContributionItemFactory PERSPECTIVES_SHORTLIST = new ContributionItemFactory(
"perspectivesShortlist") { //$NON-NLS-1$
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
return new ChangeToPerspectiveMenu(window, getId());
}
};
/**
* Workbench contribution item (id "newWizardShortlist"): A list of
* new item wizards available to be opened, arranged as a shortlist of
* promising new item wizards and an "Other" subitem. Selecting
* one of the items invokes the corresponding new item wizard.
* This action dynamically maintains the new item wizard shortlist.
* @since 1.1
*/
public static final ContributionItemFactory NEW_WIZARD_SHORTLIST = new ContributionItemFactory(
"newWizardShortlist") { //$NON-NLS-1$
/* (non-javadoc) method declared on ContributionItemFactory */
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
return new BaseNewWizardMenu(window, getId());
}
};
/**
* Workbench contribution item (id "helpSearch"): An editable field
* for entering help search queries.
* @since 1.3
*/
public static final ContributionItemFactory HELP_SEARCH = new ContributionItemFactory(
"helpSearch") {//$NON-NLS-1$
public IContributionItem create(IWorkbenchWindow window) {
if (window == null) {
throw new IllegalArgumentException();
}
return new HelpSearchContributionItem(window, getId());
}
};
}